home *** CD-ROM | disk | FTP | other *** search
/ Aminet 4 / Aminet 4 - November 1994.iso / aminet / dev / m2 / m2_part1.lha / modula / dice / dice.LHA / doc / dcpp.doc < prev    next >
Text File  |  1991-02-15  |  2KB  |  90 lines
  1.  
  2. dcpp/dcpp                                dcpp/dcpp
  3.  
  4.                  DCPP.DOC
  5.  
  6.                   C PREPROCESSOR
  7.  
  8.  
  9.                   Matthew Dillon
  10.                   891 Regal Rd.
  11.                   Berkeley, Ca. 94708
  12.                   USA
  13.  
  14.                   uunet.uu.net!overload!dillon
  15.  
  16.  
  17.  
  18.     dcpp sourcefile [-o outfile] [-I includedir ...] <options>
  19.  
  20.     DCPP automatically scans dinclude: and dinclude:amiga/ .  Any -I option
  21.     directories are searched in sequence BEFORE dinclude: or dinclude:amiga.
  22.     Directories specified with -I need not contain a trailing slash.
  23.  
  24.     As of *.**.11 dcpp also scans DINCLUDE:PD/ by default, allowing users
  25.     to install public domain include files without cluttering up the
  26.     standard includes.
  27.  
  28.     As with all DCC commands, the space between the option and the file
  29.     arguments for -o and -I is optional.
  30.  
  31.     DCpp probably does not implement everything perfectly and might fail on
  32.     some constructions.
  33.  
  34.     Dcc normally runs DCPP before DC1
  35.  
  36.                 CPP.DOC
  37.  
  38.     The following symbols are defined by default
  39.  
  40.     mc68000         -running on a 68000
  41.  
  42.     _DCC            -'DCC' compiler
  43.  
  44.     __STDC__        -ANSI __STDC__
  45.  
  46.     AMIGA            -AMIGA computer
  47.  
  48.  
  49.                Options to CPP
  50.  
  51.     -1.N
  52.         This option selects the OS.  If not specified, CPP searches
  53.         dinclude:amiga for amiga includes.    If specified, CPP searches
  54.         dinclude:amiga1N for amiga includes instead.
  55.  
  56.         DCC supports this option and passes it along to cpp.  This allows
  57.         developers to compile under either 1.3 or 1.4 (or whatever) with
  58.         the flick of an option.  DCC also uses a different amiga.lib
  59.         (see DCC docs)
  60.  
  61.     -d[#]
  62.         This option turns on CPP debugging
  63.  
  64.     -o[ ]file
  65.         This option sets the output file, otherwise stdout is used.
  66.  
  67.     -ffp
  68.         Passed from DCC, tells preprocessor to define _FFP_FLOAT.
  69.         If not specified, preprocessor defines _SP_FLOAT
  70.  
  71.  
  72.     -D[ ]define[=stuff]
  73.         This option predefines a symbol
  74.  
  75.     -E file
  76.         specify stderr file, any errors are appended to the file
  77.         instead of to stdout.  Useful for batch compiles
  78.  
  79.     -U
  80.         This option undefines certain symbols (see DOC/DCC.DOC)
  81.  
  82.     -I0
  83.         This option causes CPP *NOT* to include any default
  84.         directories in the include search list.
  85.  
  86.     -I[ ]dir
  87.         This option adds the specified directory to the include
  88.         search list.  A hanging slash on the end is not required.
  89.  
  90.